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Chapter 1 

Introducing Compile and Runtime 
Errors in Java 

Acknowledgement: Otto Seppala and Niko Myller contributed many helpful suggestions. 

1.1 Compilation errors 

Compilers are notorious for their obscure error messages like "not a statement" that leave you wondering 
what they mean. Java is the most widely used language for teaching and learning introductory programming, 
and most students and teachers use the Sun SDK (System Development Kit) either directly or indirectly 
through a development environment like BlueJ or DrJava. The error messages produced by this compiler 
are terse and many novices find it difficult to achieve even syntactically correct programs. This document is 
a guide to understanding and fixing errors in Java. 

There are three modules relating to errors discovered at compilation time: Syntax Errors in Java (Chap- 
ter 2), Semantic Errors in Java (Chapter 3) and Structural Errors in Java (Chapter 4). There are two modules 
on exceptions (errors discovered when the program is run): Exceptions in Java (Chapter 5) and Executing a 
Java Program (Chapter 6). Since many errors arise from misunderstandings of Assignment and Equality in 
Java (Chapter 7), there is a module that explains how they work with reference semantics. Finally, module 
Debugging Java Programs Without a Debugger (Chapter 8) will help you debug Java programs. 

The Eclipse development environment has its own compiler for Java. While the environment is not as 
elementary as those intended for novices, it has much to recommend it — even in introductory courses — 
because of its superior error messages and its support for identifying and correcting syntax errors. The 
compiler is incremental meaning that it checks the correctness of your program as you type. Eclipse error 
message are different from those of the Sun SDK and will be presented alongside them. 

If you doubt that an error message is correct, you can consult the formal definition of the Java language 
which is contained in the book The Java Language Specification by James Gosling, Bill Joy, Guy L. Steele 
Jr. and Gilad Bracha. It can also be downloaded from http://java.sun.com/docs/books/jls/index.html 2 . 

Before we discuss the various errors, it is important to understand that compilers are not very good 
at recovering from errors. Frequently, a single small mistake will cause the compiler to issue a cascade of 
messages. For example, in the following code, we forgot to write the closing brace of the method f : 

class~MyClass~{ 
~~void~f ()~{ 

int~ii~=~10; 

//"Error, ~closing~brace~is~missing 



1 This content is available online at <http://cnx.Org/content/m31180/l.3/>. 
2 http://java.sun. com/docs/books /jls/index.html 
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~~void~g()~{ 

int~m~=~20 ; 
~~} 
} 

An attempt to compile the program results in three error messages: 

MyClass . Java: 5 : ~illegal~start~of "expression 
~~void~g()~{ 

MyClass . j ava : 8 : ~ ' ; ' "expected 
> 

MyClass . j ava : 9 : ~ ' } ' "expected 

Do not invest any effort in trying to fix multiple error messages! Concentrate on fixing the first error and 
then recompile. 

Eclipse: Syntax error, insert "}" to complete MethodBody. Eclipse is much better at diagnosing 
this error and produces only one message. 

1.2 Runtime errors 

When the Java interpreter encounters an error during runtime it throws an exception and prints a stack 
trace showing the entire call stack — the list of methods called from the main program until the statement 
that caused the exception. 3 Consider the following program: 

class~Test~{ 
public~static~void~main(String[] ~args) ~{ 
String~s~=~"Hello~world" ; 
System. out .println(s. substring(10, 12) ) ; 

~~} 
} 

We are trying to extract a substring of the string s but the upper index 12 is not within the string. Attempting 
to execute this code will cause an exception to be thrown: 

Except ion~in~thread~ "main" 
Java. lang. StringlndexOutOf BoundsException: 
String" index~out~of "range : "12 

at~java. lang. String. substring (Unknown~Source) 

at "Test .main (Test . Java: 4) 

The exception was thrown from within the library class String during the execution of the method 
substring. This method was called at line 4 of method main in the class Test. It is unlikely that there is 
an error that causes an exception in a well established class of the Java library like String; more likely, the 
String class itself identified the error and threw the exception explicitly, so we are advised to seek the error 
starting at the deepest method of our own program. 

The calls in the stack trace are listed in reverse order of invocation, that is, the first call listed is the 
deepest method (where the exception occurred), while the last call listed is the shallowest method, namely 
main. 

Exceptions can be caught by writing a block of code called an exception handler that will be executed 
when an exception is thrown. 4 Exception handlers are discussed in textbooks on the Java language; here we 



3 Many programming languages prefer the term raises an exception and even The Java Language SpeciBcation uses this term 
•ccasion. 
An alternate terminology is to say that an exception is handled by an exception handler. 



on occasion 

4 



limit ourselves to explaining the exceptions that indicate programming errors. We further limit ourselves to 
exceptions commonly thrown by the language core; classes in the API define their own exceptions and these 
are explained in the API documentation. 
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Chapter 2 

Syntax Errors in Java 1 



Some errors are caused by violations of the syntax of Java. Although they are easy to understand, there is 
no easy way to find the exact cause of such errors except by checking the code around the location of the 
error character by character looking for the syntax error. 

2.1 ...expected 

The syntax of Java is very specific about the required punctuation. This error occurs, for example, if you 
forget a semicolon at the end of a statement or don't balance parentheses: 

if ~ (i~>~j //"Error, ~unbalanced~parentheses 

max~=~i //"Error, "missing" semicolon 

else 
~~max~=~ j ; 

Unfortunately, this syntax error is not necessarily caught precisely at the point of the mistake so you must 
carefully check the preceding characters in the line or even in a previous line in order to find the problem. 

Eclipse: 
Syntax error, insert ") Statement" to complete IfStatement 
Syntax error, insert ";" to complete Statement 
Eclipse is more informative as to the precise syntax error encountered. 

2.2 unclosed string literal 

String literals must be enclosed in quotation marks. 2 This error occurs if you fail to terminate the literal 
with quotation marks. Fortunately, the syntax of Java requires that a string literal appear entirely on one 
line so the error message appears on the same line as the mistake. If you need a string literal that is longer 
than a single line, create two or more literals and concatenate them with +: 

String~longString~= 
"This" is~f ir st "half ~of ~a~long~ string" "~+ 
"and~this~is~the~second~half . " ; 

Eclipse: String literal is not properly closed by a double-quote In Eclipse you can write a string 
literal of arbitrary length and the environment will break the string and insert the + automatically. 



1 This content is available online at <http://cnx.Org/content/m31181/l.l/>. 

2 A literal is a source-code representation of a value; most literals are of primitive types like int or char, but there are also 
literals of type String and the literal null of any reference type. 
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2.3 illegal start of expression 

Most programming constructs are either statements or expressions. This error occurs when an expression is 
expected but not found. In Java, an assignment statement is considered to be an expression which returns 
a value, so errors concerning expressions also apply to assignment statements. 3 Examples: 

• An extra right parenthesis after the condition of an if-statement: 

if ~ (i~>~j) ~) //"Error, ~extra~parenthesis 

~~max~=~i; 

Eclipse: Syntax error on token ")", delete this token 4 Eclipse diagnoses this as a simple syntax 
error and does not mention expressions. 

• Forgetting the right-hand side of an assignment statement: 

max~=~ ; //"Error ,~missing~right -hand" side 

Eclipse: Syntax error on token " = ", Expression expected after this token 

2.4 not a statement 

This error occurs when a syntactically correct statement does not appear where it should. Examples: 

• Writing an assignment statement without the assignment operator: 

max" ; //"Error ,~missing~= 

Eclipse: Syntax error, insert "AssignmentOperator Expression" to complete Expression 

• Misspelling else: 

if~(i~>~j) 
~~max~=~i; 
els~; //"Error, ~else~not~spelled~correctly 

The reason you do not get "else expected" is that you need not write an else alternative so this just 
looks like a bad statement. 

Eclipse: 

els cannot be resolved 

Syntax error, insert "AssignmentOperator Expression" to complete Expression 

The same identifier can be used in different methods and classes. An important task of the compiler 
is to resolve the ambiguity of multiple uses of the same identifer; for example, if a variable is declared 
both directly within a class and also within a method, the use of its unqualified name is resolved in 
favor of the local variable. This error message simply means that the compiler could not obtain an 
(unambiguous) meaning for the identifier els. 

• The following code: 

if-(i->-j) 

~~max~=~i; 

els //"Error ,~else~not "spelled" correctly 

~~max~=~j; 



3 The value of an assignment statement considered as an expression is the value of the expression on the right-hand side that 
is assigned to the variable on the left-hand side. 

4 The syntax of a programming language is defined in terms of tokens consisting of one or more characters. Identifiers and 
reserved keywords are tokens as are single characters like + and sequences of characters like !=. 



results in a weird error message: 

x. Java: 6 : ~canrLOt~f ind~symbol 
symbol"" : ~class~els 
location: ~class~x 
els 

The reason is that the compiler interprets this as a declaration: 

els~max~=~j ; 

and can't find a class els as the type of the variable max. 

Eclipse: Duplicate local variable maxels cannot be resolved to a type These messages are 
more helpful: first, the use of the word type instead of class is more exact because the type of a variable 
need not be a class (it could be a primitive type or interface); second, the message about the duplicate 
variable gives an extra clue as to the source of the error. 
• The error can also be caused by attempting to declare a variable whose name is that of a reserved 
keyword: 

void~f ()~{ 
~~int "default ~=~ 10; 

} 

Eclipse:Syntax error on token "default", invalid VariableDeclaratorld 

2.5 cannot find symbol 

This is probably the most common compile-time error. All identifiers in Java must be declared before being 
used and an inconsistency between the declaration of an identifier and its use will give rise to this error. 
Carefully check the spelling of the identifier. It is easy to make a mistake by using a lower-case letter 
instead of an upper case one, or to confuse the letter O with the numeral and the letter 1 with the numeral 
1. 

Other sources of this error are: calling a constructor with an incorrect parameter signature, and using 
an identifier outside its scope, for example, using an identifier declared in a f or-loop outside the loop: 

int[]~a~=~{l,~2,~3}; 
int~sum~=~0; 
for" (int~i~=~0;~i~<~a. length; ~i++) 

sum~=~sum~+~a[i] ; 
System. out . print In ( "Last ~=~"~+~i) ; //"Error, ~i~not~in~ scope 

Eclipse: ... cannot be resolved 

2.6 ... is already defined in ... 

An identifier can only be declared once in the same scope: 

int~sum~=~0; 
double~sum~=~0 . ; //"Error , ~sum~already "defined 

Eclipse: Duplicate local variable sum 
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2.7 array required but ... found 

This error is caused by attempting to index a variable which is not an array. 

int~max(int~i, ~int~j) ~{ 
if ~(i~>~ j) "return" i; 

else~return~j [i] ; //"Error, ~j~is~not~an~array 

> 

Eclipse: The type of the expression must be an array type but it resolved to int 

2.8 ... has private access in ... 

It is illegal to access a variable declared private outside its class. 
Eclipse: The field ... is not visible 



Chapter 3 

Semantic Errors in Java 1 



This group of errors results from code that is syntactically correct but violates the semantics of Java, in 
particular the rules relating to type checking. 

3.1 variable ... might not have been initialized 

An instance variable declared in a class has a default initial value. 2 However, a local variable declared within 
a method does not, so you are required to initialize it before use, either in its declaration or in an assignment 
statement: 

void~m(int~n) ~{ //~n~is~iiiitialized~from~trie~actual~parameter 
~~int~i,~j; 

~~i~=~2; //~i~is~initialized~by~th.e~assigiimeiit 

~~int~k~=~l ; //~k~is~initialized~in~its~declaration 

~~if~(i~==~n) //~0K 

k~=~j ; //"Error, ~j~is~not "initialized 

~~else 
~~~~ r= ~ k . 

} 

The variable must be initialized on every path from declaration to use even if the semantics of the program 
ensure that the path cannot be taken: 

void~m(int~n) ~{ 
~~int~i; 
~~if ~(n~==~n) //~Always~true 

i~=~n; 
""else 

n~=~i; //"Error, ~altriough~never~executed! ! 

} 

Eclipse: The local variable ... may not have been initialized 

Note: If the expression in the if -statement can be computed at compile-time: 

if" (true) //~0K 

if~('n'~==~'n') //~0K 

the error will not occur. 



1 This content is available online at <http://cnx.Org/content/m31182/l.l/>. 

2 A cJass is a template that is used to create or instantiateinstances called objects. Since memory is allocated separately for 
each object, these variables are called instance variables. 

9 
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3.2 ... in ... cannot be applied to ... 

This error message is very common and results from an incompatibility between a method call and the 
method's declaration: 

void~m(int~i) ~{~ . . . ~} 

m(5 . 5) ; //"Error , ~th.e~literal~is~of ~type~double, ~not~int 

Check the declaration and call carefully. You can also get the error message cannot find symbol if the 
declaration of the method is in the API. 3 

Eclipse: The method ... in the type ... is not applicable for the arguments ... 

3.3 operator ... cannot be applied to ....... 

Operators are only defined for certain types, although implicit type conversion is allowed between certain 
numeric types: 

int~a~=~5; 
boolean~b~=~true ; 

int~c~=~a~+~b; //"Error, ~caii't~add~a~booleaii~value 

double~d~=~a~+~l .4;~~//~0K, ~int~is~implicitly~converted~to~double 

Eclipse: The operator + is undefined for the argument type(s) int, boolean 

3.4 possible loss of precision 

This error arises when trying to assign a value of higher precision to a variable of lower precision without 
an explicit type cast. Surprisingly, perhaps, floating point literals are of type double and you will get this 
message if you try to assign one to a variable of type float: 

f loat~sum~=~0 . 0; //"Error, ~literal~is~not~of ~type~f loat 

The correct way to do this is to use a literal of type float or an explicit type cast: 

f loat~sum~=~0 . Of ; //~0K 

f loat~sum~=~ (float) "0 . ; ~~//~0K 

Eclipse: Type mismatch: cannot convert from double to float 

3.5 incompatible types 

Java checks that the type of an expression is compatible with the type of the variable in an assignment 
statement and this error will result if they are incompatible: 

boolean~b~=~true ; 
int~a~=~b; //"Error, ~can't~assign~boolean~to~int 



3 The Application Programming Interface (API) describes how to use the library of classes supplied as part of the Java 
system. By extension, it is also used as a name for the library itself. 
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Eclipse: Type mismatch: cannot convert from boolean to int 
Important note 

In the C language it is (unfortunately!) legal to write if (a = b) using the assignment operator instead of 
if (a == b) using the equality operator. The meaning is to execute the assignment, convert the value to 
an integer and use its value to make the decision for the if -statement (zero is false and non-zero is true). 
In Java, the assignment is legal and results in a value, but (unless a is of type boolean!) this error message 
will result because the expression in an if -statement must be of type boolean, not int. Writing == instead 
of = becomes a simple compile-time error in Java, whereas in C this error leads to runtime errors that are 
extremely difficult to find. 

3.6 inconvertible types 

Not every type conversion is legal: 

boolean~b~=~true ; 
int~x~=~ (int) ~b; //"Error, ~can't~convert~boolean~to~int 

Eclipse: Type mismatch: cannot convert from ... to ... 
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Chapter 4 

Structural Errors in Java 1 

4.1 Methods and return statements 

There are a number of errors related to the structure of methods and their return statements; in general 
they are easy to fix. 

4.1.1 missing return statement 

When a method returns a non-void type, every path that leaves the method must have a return- 
statement, 2 even if there is no way that the path can be executed: 

int~max(int~i, ~int~j) ~{ 
if ~(i~>~ j) "return" i; 
else" if ~(i~<=~j) "return" j ; 

//"Error: ~wh.at~about~th.e~path~when~i>j , ~i<=j~are~both~f alse?! ! 
> 

Adding a dummy alternative else return ; at the end of the method will enable successful compilation. 
Eclipse:This method must return a result of type int This Eclipse message is rather hard to 
understand because, clearly, the method does return a result of type int, just not on all paths. 

4.1.2 missing return value 

A method returning a type must have a return-statement that includes an expression of the correct type: 

int~max(int~i, ~int~j) ~{ 
return; //"Error ,~missing~int "expression 

} 

Eclipse: This method must return a result of type int 

4.1.3 cannot return a value from method whose result type is void 

Conversely, a return-statement in a void method must not have an expression: 

void~m(int~i , ~int~ j ) ~{ 
return" i~+~j ; //"Error ,~the~method~was~declared~ void 

> 

Eclipse: Void methods cannot return a value 



1 This content is available online at <http://cnx.Org/content/m31183/l.l/>. 
2 A path may also leave the method via a throw statement. 



13 



14 CHAPTER 4. STRUCTURAL ERRORS IN JAVA 

4.1.4 invalid method declaration; return type required 

Every method except constructors must have a return type or void specified; if not, this error will arise: 
max(int~i, ~int~j) ~{ 

} 

The error frequently occurs because it is easy to misspell the name of a constructor; the compiler then thinks 
that it is a normal method without a return type: 

class~MyClass~{ 
~~MyClass(int~i)~{~. . ."} 

~~Myclass(int~i, ~int~j) ~{~ . . ."} //"Error : ~lowercase~c 
} 

Eclipse: Return type for the method is missing 

4.1.5 unreachable statement 

The error can occur if you write a statement after a return statement: 

void~m(int~ j ) ~{ 
~ "System. out .print In (" Value" is~"~+~j) ; 
~ "return; 

~~j++; 

} 

The check is purely syntactic, so the error will occur in the following method: 

if~(true)~{ 
~~return~n~+~l ; //~Only~this~alternative~executed,~but~ . . . 

} 

else~{ 

~ ~return~n~ - ~ 1 ; 

~~n~=~n~+~l; //". . . ~this~is~an~error 

> 

Eclipse: Unreachable code 

4.2 Access to static entities 

The modifier static means that a variable or method is associated with a class and not with individual 
objects of a class. 3 Normally, static entities are rarely used in Java (other than for the declaration of 
constants), because programs are written as classes to be instantiated to create at least one object: 

class~MyClass~{ 
~~int~f ield; 
~~void~m(int~parm) ~{ 

f ield~=~parm; 
~~} 
~~public~static~void~main(String[] ~args) ~{ 

MyClass~myclass~=~new~MyClass() ; //~Create~object 



5 static has other uses that we do not consider here: (a) as a modifier for nested classes and (b) in static initializers. 
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my class .m(5) ; //~Call~object ' s~method 

System. out .print In (my class .field) ;~~//~Access~object 's~f ield 
""} 
} 

Some teachers of elementary programming in Java prefer to start with a procedural approach that involves 
writing a class containing static variables and static methods that are accessed from the main method without 
instantiating an object as was done above: 

class~MyClassl~{ 
~~static~int~f ield; 
~~static~void~m(int~parm) ~{ 

f ield~=~parm; 
~~} 

~~public~static~void~main(String[] ~args) ~{ 
m(5); //~0K 

System. out .println(f ield) ; //~0K 

~~} 
} 



4,2,1 non-static variable ... cannot be referenced from a static context 

Since the method main is (required to be) static, so must any variable declared in the class that is accessed 
by the method. Omitting the modifier results in a compile-time error: 

int "field; //"Forgot ""static" 

""System, out .println(f ield) ; //"Error, ~wh.ich.~f ield? 



The variable field does not exist until an object of the class is instantiated, so using the identifier field 
by itself is impossible before objects are instantiated. Furthermore, it is ambiguous afterwards, as there may 
be many objects of the same class. 

Eclipse: Cannot make a static reference to the non-static field ... 

4,2,2 non-static method ... cannot be referenced from a static context 

Similarly, a non-static method cannot be called from a static method like main; the reason is a bit subtle. 
When a non-static method like m is executed, it receives as an implicit parameter the reference to an object. 
(The reference can be explicitly referred to using this.) Therefore, when it accesses variables declared in 
the class like field: 

void~m(int~parm) ~{ //"Forgot ""static" 

f ield~=~parm; //"Error, ~which~f ield? 

} 

public" st at ic~void~main (String [] ~args)~{ 
~~m(5); 

} 

it is clear that the variable is the one associated with the object referenced by this. Thus, in the absence 
of an object, it is meaningless to call a non-static method from a static method. 

Eclipse: Cannot make a static reference to the non-static method ... from the type ... 
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Chapter 5 

Exceptions in Java 1 



5.1 Out of range 

These exceptions are the most common and are caused by attempting to access an array or string with an 
index that is outside the limits of the array or string. C programmers will be familiar with the difficult bugs 
that are caused by such errors which "smear" memory belonging to other variables; in Java the errors cause 
an exception immediately when they occur thus facilitating debugging. 

5.1.1 ArraylndexOutOfRange 

This exception is thrown when attempting the index an array a[i] where the index i is not within the 
values and a. length- 1, inclusive. Zero-based arrays can be confusing; since the length of the array is 
larger than the last index, it is not unusual to write the following in a f or-statement by mistake: 

final~static~int~SIZE~=~10; 
int~a~=~new~int [SIZE] ; 

for~(int~i~=~0;~i~<=~SIZE;~i++) //"Error ,~<=~should~be~< 

for" (int~i~=~0;~i~<=~a. length; ~i++) "//"Better, ~but~still~an~error 

5.1.2 StringlndexOutOfRange 

This exception is thrown by many methods of the class String if an index is not within the values and 
s.lengthO, inclusive. Note that s.lengthO is valid and means the position just after the last character 
in the string. 

5.2 NullPointerException 

A variable in Java is either of a primitive type such as int or boolean or of a reference type: an array type, 
the type of a class defined in the Java API such as String, or the type of a class that you define such as 
MyClass. When declaring a variable of a reference type, you only get a variable that can hold a reference 
to an object of that class. At this point, attempting to access a field or method of the class will cause the 
exception NullPointerException to be thrown: 2 



1 This content is available online at <http://cnx.Org/content/m31184/l.l/>. 

2 The name of the exception is an anachronism, because there are no (explicit) pointers in Java. 
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class~YourClass~{ 
static~MyClass~my; //~Can~hold~a~ref erence~but "doesn't "yet 

public~static~void~maiii(Striiig[] ~args) ~{ 

my .m(5) ; //~Throws~NullPointerException 

~~} 
} 

Only after instantiating the class and executing the constructor do you get an object: 

class~YourClass~{ 
static~MyClass~my; //~Can~hold~a~ref erence~but "doesn't ~yet 

public~static~void~main(String[] ~args) ~{ 

my~=~new~MyClass() ; ~//~Instantiates~an~object 

II and~assigns~the~ref erence 
my .m(5) ; //~Throws~NullPointerException 

~~} 
} 

This exception is not often seen in this context because Java style prefers that the declaration of the variable 
include the instantiation as its initial value: 

class~YourClass~{ 
//"Declarat ion~+~inst ant iation~of ~ class" variable 
static~MyClass~myl~=~new~MyClass() ; 

public~static~void~main(String[] ~args) ~{ 
myl.m(5) ; //~0K 

//"Declarat ion~+~inst ant iation~of "local" variable 

MyClass~my2~=~new~MyClass() ; 

my2.m(5) ; //~0K 

~~} 
} 

Sometimes, you cannot initialize a variable at its declaration; an obvious place to initialize an instance 
variable is within its constructor: 

class~YourClass~{ 
MyClass [] ~my ; //~Can't~initialize~here~because~ . . . 

YourClass (int~size) ~{ //" . . . ~size~of ~array~dif f erent~f or~each 
object~my~=~new~MyClass [size] ; 
~~} 
} 

The exception is likely to occur when you declare an array whose elements are of reference type. It is easy 
to forget that the array contains only references and that each element must be separately initialized: 

MyClass [] ~my~=~new~MyClass [4] ; //~Array~of "references 

my[l] .m(5) ; //~Raises~an~exception 

for" (int~i~=~0;~i~<~my . length; ~i++) 

my [i] ~=~new~MyClass() ; //" Inst ant iate~objects 

my[l] .m(5) ; //~0K 
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Finally, NullPointerException will occur if you get a reference as a return value from a method and don't 
know or don't check that the value is non-null: 3 

Node~node~=~getNextNode() ; 
if ~ (node .key~>~this .key) ~ . . . //~Error~if ~node~is~null ! 

if ~ (node" !=~null) ~{ //~This~should~be~done~f irst 

~~if "(node. key~>~this .key) ~ . . . 

} 

5.3 Computational errors 

The following three exceptions occur when you try to convert a string to a number and the form of the string 
does not match that of a number, for example "12a3". 

5.3.1 InputMismatchException 

This exception is thrown by the class Scanner, which is a class introduced into version 5 of Java to simplify 
character-based input to programs. 

5.3.2 IllegalFormatException 

This exception is thrown by the method format in class String that enables output using format specifiers 
as in the C language. 

5.3.3 NumberFormatException 

This exception is thrown by methods declared in the numeric "wrapper" classes such as Integer and Double, 
in particular by the methods parselnt and parseDouble that convert from strings to the primitive numeric 
types. 

5.3.4 ArithmeticException 

This exception is thrown if you attempt to divide by zero. 

Important note 
Most computational errors do not result in the raising of an exception! Instead, the result is an artificial 
value called NaN, short for Not a Number. This value can even be printed: 

double~x~=~Math. sqrt (-1) ;~~//~Does~not~throw~an~exception! 
System. out .println(x) ; 

Any attempt to perform further computation with NaN does not change the value. That is, if x is NaN then so 
is y after executing y = x+5. It follows that an output value of NaN gives no information as to the statement 
that first produced it. You will have to set breakpoints or use print statements to search for it. 

5.4 Insufficient memory 

Modern computers have very large memories so you are unlikely to encounter these exceptions in routine 
programming. Nevertheless, they can occur as a side effect of other mistakes. 



! You could know this if the method has been verified for a postcondition that specifies a non-null return value. 
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5.4.1 outOfMemoryError 

This exception can be thrown if you run out of memory: 
int~a~=~new~iiit [100000000] ; 

5.4.2 StackOverFlowArea 

A stack is used to store the activation record of each method that is called; it contains the parameters and 
the local variables as well as other information such as the return address. Unbounded recursion can cause 
the Java Virtual Machine to run out of space in the stack: 

int~f actorial (int~n) ~{ 
if ~(n~==~0) ~return~l ; 

else~return~n~*~f actorial (n~+~l) ; ~~//~Error , ~you.~meant~ii~-~l 
> 



Chapter 6 

Executing a Java Program 1 



You can run a Java program from within an environment or by executing the interpreter from the command 
line: 

java~Test 

where Test is the name of a class containing a main method. 

Suggestion: It is convenient to write main methods in most classes and to use then for testing classes 
individually. After the classes are integrated into a single program, you only need ensure that the interpreter 
is invoked on the class that contains the "real" main method. 

Two runtime errors can occur if the interpreter is not successful in finding and running the program. 

6.1 NoClassDefFoundError 

The interpreter must be able to find the file containing a class with the main method, for example, 
Test. class. If packages are not used, this must be in the directory where the interpreter is executed. 
Check that the name of the class is the same as the name of the file without the extension. Case is signifi- 
cant! 

Warning! If you are compiling and running Java from a command window or shell with a history facility, 
you are likely to encounter this error. First, you compile the program: 

javac~MyClass . Java 

and then you recall that line and erase the c from javac to obtain the command for the interpreter: 

j ava~MyClass . j ava 

Unfortunately, MyClass. Java is not the name of the class so you will get this exception. You must erase the 
. j ava extension as well to run the interpreter: 

java~MyClass 

If you are using packages, the main class must be in a subdirectory of that name. For example, given: 

package~projectl . userinterf ace; 
class~Test~{ 

public~static~void~main(String[] ~args) ~{ 

~~} 
} 



1 This content is available online at <http://cnx.Org/content/m31186/l.l/>. 
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the file Test, class must be located in the directory userinterf ace that is a subdirectory of projectl 
that is a subdirectory of the directory where the interpreter is executed: 

c: \projects>~dir 

<DIR>~projectl 
c: \projects>~dir "projectl 

<DIR> "user interface 
c: \pro j ect s>~dir "pro jectl\user interface 

Test . class 

The program is invoked by giving the fully qualified name made up of the package names and the class name: 
c: \projects>~java~projectl .userinterf ace .Test 

6.2 NoSuchMethodFoundError: main 

This error will occur if there is no method main in the class, or if the declaration is not precisely correct: 
the static modifier, the void return type, the method name main written in lower case, and one parameter 
of type String []. If you forget the public modifier, the error message is Main method not public. 



Chapter 7 

Assignment and Equality in Java 1 



Java programmers make mistakes in the use of the assignment and equality operators, especially when strings 
are used. The concept of reference semantics is (or should be) explained in detail in your textbook, so we 
limit ourselves to a reminder of the potential problems. 

7.1 String equality 

Given: 

String" sl~=~"abcdef " ; 
String~s2~=~"abcdef " ; 
String~s3~=~"abc"~+~"def " ; 
String" s4~=~"abcdef »~+~'"' ; 
String~s5~=~sl~+~""; 
String~tl~=~"abc"; 
String~t2~=~"def "; 
String~s6~=~tl~+~t2; 

all strings sn are equal when compared using the method equals in the class String that compares the 
contents pointed to by the reference: 

if ~ (si . equals (s5) ) //~Condition~evaluates~to~true 

The string literal" abcdef " is stored only once, so strings si, s2 and (perhaps surprisingly) s3 and s4 are 
also equal when compared using the equality operator == that compares the references themselves: 

if ~ (sl~==~s3) //~Condition~evaluates~to~true 

However, s5 and s6 are not equal (==) to si through s4, because their values are created at runtime and 
stored separately; therefore, their references are not the same as they are for the literals created at compile- 
time. 

Always use equals rather than == to compare strings, unless you can explain why the latter is needed! 

7.2 Assignment of references 

The assignment operator copies references, not the contents of an object. Given: 



1 This content is available online at <http://cnx.Org/content/m31187/l.l/>. 
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int[]~al~=~{~l,~2,~3,~4,~5~}; 
int []~a2~=~al; 
al[0]~=~6; 

since a2 points to the same array, the value of a2[0] is also changed to 6. To copy an array, you have to 
write an explicit loop and copy the elements one by one. 

To copy an object pointed to by a reference, you can create a new object and pass the old object as a 
parameter to a constructor: 

class~MyClass~{ 
int~x; 

MyClass(int~y) ~{~x~=~y; ~} 

MyClass (MyClass~myclass) ~{~this . x~=~myclass . x ; ~} 
} 

class~Test~{ 

public~static~void~main(String[] ~args) ~{ 

MyClass~myclassl~=~new~MyClass(5) ; 

MyClass~myclass2~=~new~MyClass(myclassl) ; 

myclassl . x~=~6 ; 

System. out .println (myclassl .x) ; ~~//~Prints~6 

System. out . println (myclass2 .x) ; ~~//~Prints~5 
~~} 
} 

Alternatively, you can use clone as described in Java textbooks. 



Chapter 8 

Debugging Java Programs Without a 
Debugger 1 



Debugging is perhaps best done using a debugger such as those provided by integrated development envi- 
ronments. Nevertheless, many programmers debug programs by inserting print statements. This section 
describes some of the techniques that can be used in Java. 

8.1 Printing number data and arrays 

The methods System, out .print and System, out .println are predefined for primitive types as well as for 
strings: 

int~i~=~l; 
double~d~=~5 . 2 ; 
System. out .print (i) ; 
System. out .println (d) ; 

Furthermore, automatic conversion to String type is performed by the concatenation operator +: 

System. out .println("d~=~"~+~d~+~"and~i~=~"~+~i) ; 

The print statements can not print an entire array, so a method must be written: 

public~static~void~print (int [] ~a) ~{ 
~~f or" (int~i~=~0; ~i~<~a. length; ~i++) 

System. out .print (a[i] ) ; 
""System, out .printlnO ; 

} 

public" st at ic~void~main (String [] ~args)~{ 
~~int[]~a~=~{l,~2,~3,~4,~5,~6,~7,~8,~9,~10~}; 
~~print (a) ; 
> 

Since the number of elements of an array can be large, it is better to write the method so that it inserts a 
newline after printing a fixed number of elements: 



1 This content is available online at <http://cnx.Org/content/m31188/l.l/>. 
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public~static~void~print (int [] ~a) ~{ 
for" (int~i~=~0; ~i~<~a. length; ~i++)~{ 

System. out .print (a[i] ) ; 

if ~ (i~°/„~8~==~7)~ "System, out .print In () ; 
~~} 

""System. out .println() ; 
> 

You can put this static method in a publicly accessible class and use it to print any integer array. Similar 
methods can be written for the other primitive types. 

8.2 Converting objects to strings 

Within the class Object, the root class for all other classes, a method toString is declared. The default 
implementation will not give useful information, so it is a good idea to override it in each class that you 
write: 

class~Node~{ 
~~int~key ; 
~~double~value ; 
~~public~String~toString() ~{ 

return" "The" value~at "key ~"~+~key~+~"~ is" "~+~value; 
""} 
} 

Then, you can simply call the print statements for any object of this class and the conversion to String is 
done automatically: 

Node~node~=~new~Node() ; 

System. out .println(node) ; 

The predefined class java.util. Arrays constains a lot of useful (static) methods for working with arrays, 
among them toString methods for arrays whose elements are of any primitive type: 

int[]~a~=~{l,~2,~3,~4,~5,~6,~7,~8,~9,~10~}; 
System. out .print In (java.util .Arrays .toString (a) ) ; 



import~java.util .Arrays; 

System. out .print In (Arrays .toString (a) ) ; 

You will receive a predefined representation of the array (the elements are separated by commas), so if you 
want an alternate representation (such as printing on multiple lines) you will have to write your own print 
method as we did in the previous section. 

An array of objects of any reference type can be printed by defing a single method since any object can 
be converted to Object: 

public~static~void~print (Object [] ~a) ~{ 
~~f or~ (int~i~=~0; ~i~<~a. length; ~i++) 

System. out .print (a[i] ) ; 
""System, out .printlnO ; 

} 
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Node [] ~nodes~=~new~Node [] ; 

. . . //~Create~elements~of ~the~array 

print (nodes) ; 

or by calling the predefined method deepToString: 

Node [] ~nodes~=~new~Node [] ; 

. . . //~Create~elements~of ~the~array 

System. out . print In (Java, lit il .Arrays .deepToString (node) ) ; 

8.3 Forcing a stack trace 

Suppose that you have isolated a bug to a certain method but you do not know which call of that method 
was responsible. You can force the interpreter to print a trace of the call stack by inserting the line: 

new~Exception() .printStackTraceO ; 

within the method. It creates a new object of type Exception and then invokes the method 
printStackTrace. Since the exception is not thrown, the execution of the program proceeds with no 
interruption. A program can always be terminated by calling System, exit (n) for an integer n. 

8.4 Leave the debug statements in the program 

Once you have found a bug, it is tempting to delete the print statements used for debugging, but it is better 
not to do so because you may need them in the future. You can comment out the statements that you don't 
need, but a better solution is to declare a global constant and then use it to turn the print statements on 
and off: 

public" class~Global~{ 
~ "public" st at ic~boolean~DEBUG~=~f alse; 
~~public~static~void~print (int [] ~a) ~{ . . . } 
~~public~static~void~print (Object [] ~a)~{ . . .} 

} 

~~if ~ (Global . DEBUG) "Global . print (nodes) ; 
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Compile and Runtime Errors in Java 

This document explains the compile and runtime errors that can occur when writing Java programs. 
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